home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 013a / 2col27.zip / 2COL.DOC next >
Text File  |  1991-12-31  |  13KB  |  347 lines
  1.                                  2col
  2.  
  3.                          Shareware Version 2.7
  4.  
  5.                       A Compressed Print Utility
  6.  
  7.                             Copyright 1991
  8.                                   by
  9.  
  10.                           ARCaine Technology
  11.                             960 Neilson St
  12.                            Albany, CA 94706
  13.                             (510) 527-9859
  14.  
  15.                           All Rights Reserved
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23. Introduction
  24.  
  25.   2col is intended to greatly reduce the huge volume of paper that
  26.   results from printing reference manuals and text files. Regular
  27.   use of this program should cut your paper bill by 60 to 70
  28.   percent. It provides excellent readability (unlike other
  29.   compressed print programs) while compressing an average of
  30.   four pages of source material onto one side of a sheet of
  31.   paper. By using its even/odd alternate side print feature eight
  32.   pages of text can be printed using both sides of a page. Since the
  33.   normal draft mode of printing is used it is also much faster than
  34.   those programs which rely on nonstandard print modes.
  35.  
  36.   By reducing the volume of paper, 2col also reduces storage
  37.   requirements and the bulk one has to carry around when traveling.
  38.  
  39.   As a side benefit, many 2col users actually find it easier and
  40.   faster to read the compressed versions than the originals because
  41.   they can take in more words at one time without having to scan
  42.   across the page.
  43.  
  44.   2col will optionally print in subscript mode - doubling the amount
  45.   of text contained on a single sheet to a total of sixteen pages -
  46.   with a significant loss in legibility and printing speed. This
  47.   mode is intended mainly for archival use not for documents that
  48.   will be read frequently.
  49.  
  50.   This program will work on most dot-matrix printers which provide
  51.   17 characters/inch compressed printing but is especially intended
  52.   for newer printers which have a compressed/elite mode (20 char/in)
  53.   allowing two complete 80 character lines to be printed across the
  54.   page. Printers which support 20 char/in include:KXP1180, FX86,
  55.   200GX,etc.Since most printers do not show the 20 char/inch mode on
  56.   the front panel, you should check the manual or just try printing
  57.   with 2col. If your printer supports 20 char/in but does not
  58.   operate properly with 2col, let me know and I will try to provide
  59.   you with an updated version that is compatible with your printer.
  60.  
  61.   The 20 char/in mode on many printers cannot be accessed by
  62.   software if your DIP switches are set for IBM mode. The printer
  63.   must be set for the Epson standard mode. 2col will optionally
  64.   supply the control characters to cause the full IBM character set
  65.   to print. Also, your printer should have the auto linefeed switch
  66.   turned off.
  67.  
  68.  
  69. 24-Pin Printers
  70.  
  71.   I have not included 24-pin printer support in the unregistered
  72.   version becuse, so far, this is the only way I have been able to
  73.   get any registrations for 2col. Those with 24-pin printers can run
  74.   this demo version, but will find that pages print too long. The
  75.   registered version of 2col supports 24-pin printers.
  76.  
  77.  
  78. Registration
  79.  
  80.   I will keep improving the program if I know enough people are
  81.   finding it useful.
  82.  
  83.   My registration policy is very flexible. The nominal fee is $20.
  84.   If you don't feel you will get $20 worth of use out of the
  85.   program, send whatever it is worth to you. If you are impoverished
  86.   and can't afford to pay anything, send me a stamped self-addressed
  87.   envelope and I will send you a registered version of 2col.
  88.  
  89.   This is not freeware or public domain. You are required to
  90.   register if you intend to use this program after a reasonable
  91.   trial period.
  92.  
  93.   The registered version of 2col permits multiple document names and
  94.   wildcards to be used on the command line and eliminates the
  95.   registration screen. It also allows output to be directed to a
  96.   file instead of the printer. Please tell me the version number you
  97.   have when registering. Registration checks should be made payable
  98.   to "Tony Caine".
  99.  
  100.   Multi-site fees for commercial users can be negotiated.
  101.  
  102.  
  103. Terminology
  104.  
  105.   Since several pages from the original source file are combined
  106.   onto a single page of printer output, there may be some confusion
  107.   about the word "page." We will always refer to the original
  108.   document pages as "source pages." What is actually printed will
  109.   simply be called "pages."
  110.  
  111.  
  112.  
  113. Usage:
  114.  
  115.   2col  [options] path\filename [options] [path\filename]...
  116.  
  117.  
  118.   Options may be specified in any order before and/or after the file
  119.   name(s). Options must be separated from each other by spaces and
  120.   preceded by a "-". Upper and lower case are interchangeable.
  121.  
  122.  
  123.  
  124.  
  125.   Options are defined as follows:
  126.  
  127.    -Lxx = Each column will be xx lines long
  128.    -Cxx = No more than xx consecutive blank lines will be printed
  129.    -Sxx = Skip xx pages before starting to print
  130.    -O   = Print only odd # pages
  131.    -E   = Print only even # pages
  132.    -Wxx = column width (number of characters in each column)
  133.    -P   = Pause before printing each page.
  134.    -N   = Prints filename and page # at lower left corner
  135.    -D   = Delimit each (source) page with a line and page #
  136.    -T   = Truncate long lines instead of wrap.
  137.    -G   = Enable full IBM graphics set.
  138.    -Fx  = Put a margin of x blank lines at the top of each page.
  139.    -Mx  = Set left margin x spaces from the edge.(see caution below)
  140.    -A   = Append multiple files. (registered version only)
  141.    -Z   = Route output to disk. (registered version only)
  142.  
  143.   When more than 102 lines/page requested,shifts to subscript
  144.   (half-height) mode. When column width is less than 69 chars,uses
  145.   compressed mode (17 char/in.) When column width is greater than
  146.   68 uses compressed/elite (20 char/in.)
  147.  
  148.   Defaults: 80 characters/column;88 lines/page;1 consecutive blank
  149.            line; no pause before printing page; do not number pages;
  150.            wrap (not truncate) long lines;4 blank lines at top of
  151.            page.
  152.  
  153.  
  154. Description of options
  155.  
  156.  
  157.    -Lxxx
  158.  
  159.       Each column will contain xxx lines of data. Line spacing will
  160.       be automatically adjusted to approximately fill the page. Some
  161.       flexibility is included to vary the white space at the bottom
  162.       of the page: -L102 or -L90 (-L100 or -L85 for 24-pin printers)
  163.       gives minimum white space; other values give more.  Characters
  164.       will be normal (pica) height until more than 102 lines/column
  165.       are specified; printer will then shift to subscript mode
  166.       allowing up to 220 lines/column. Default value is 88.
  167.  
  168.  
  169.  
  170.     -Cxx
  171.  
  172.       Pages of text frequently contain many blank lines of data.
  173.       Experience has shown that most of these can be discarded
  174.       without sacrificing readability. This option specifies that
  175.       when there are more than xx consecutive blank lines, the
  176.       excess will be discarded. The default value is 1.
  177.  
  178.  
  179.     -Sxx
  180.  
  181.       This feature is useful if you have a paper jam or decide to
  182.       print part now and part later. Using this option will cause xx
  183.       pages to be skipped before printing begins. For example,
  184.       specifying "-S2" will cause printing to begin with page 3.
  185.  
  186.  
  187.     -O
  188.  
  189.       This and the -E option allow you to print on both sides of
  190.       each sheet of paper. By specifying "-O", only the odd numbered
  191.       pages will be printed. When printing is complete,reload the
  192.       first page back into the printer with the blank side facing
  193.       the print head and rerun 2col using the -E option.
  194.  
  195.  
  196.     -E
  197.  
  198.       Prints only even numbered pages. When using this option after
  199.       the -O option be sure to shift the paper about 1/2 inch to the
  200.       right before starting to print, to allow space for hole
  201.       punching or other binding requirements.
  202.  
  203.  
  204.     -Wxx
  205.  
  206.       This option specifies how wide each column will be. Wrapping
  207.       or truncating will begin at this position. It also determines
  208.       the print density. If xx is 68 or less, the printer will use
  209.       compressed mode (137 characters across the page). If xx is 69
  210.       or larger the printer will use compressed/elite (160
  211.       characters/line). If your printer does not support
  212.       compressed/elite and you try to use it, you will end up with a
  213.       mess. You should then specify xx as 68 and decide whether you
  214.       want to truncate long lines or wrap them. You may first want
  215.       to use a word processor to do a word wrap since 2col will wrap
  216.       in mid-word.
  217.  
  218.  
  219.     -P
  220.  
  221.       Program will pause before printing each page. Hit any key to
  222.       print a page. This option is useful if you are feeding single
  223.       sheets to the printer.
  224.  
  225.  
  226.     -N
  227.  
  228.       This will cause the filename and page number to be printed in
  229.       the lower left-hand corner of each sheet. To avoid confusion
  230.       when using the -S, -O and -E options the page numbering is not
  231.       reset for each document when multiple documents are specified
  232.       on the command line(registered version only).
  233.  
  234.  
  235.     -D
  236.  
  237.       If you need to keep track of each source page, this option
  238.       will print a dashed line with a page number in the middle
  239.       whenever a form feed is encountered or after 66 lines of data.
  240.       Experience has shown that this option will be rarely used
  241.       because most documents either number their own pages or it is
  242.       just not important to keep track of original page breaks.
  243.  
  244.  
  245.     -T
  246.  
  247.       Normally when lines longer than the specified column width are
  248.       encountered, 2col will wrap the data to the next line. If you
  249.       prefer to truncate or discard excess characters on a line, you
  250.       should invoke this option.
  251.  
  252.  
  253.  
  254.     -G
  255.  
  256.       Sends control codes to enable full IBM graphics set (ASCII
  257.       128-255).
  258.  
  259.  
  260.  
  261.  
  262.     -Fx
  263.  
  264.       2col will insert x blank lines at the top of each page before
  265.       printing. The default is 4.
  266.  
  267.  
  268.     -Mx
  269.  
  270.       This command sets the left margin x spaces from the edge of
  271.       the page. Default is 0. Use this option with caution! Most
  272.       standard width printers only have 160 print positions across
  273.       the page. If you insert spaces with a margin command, the
  274.       printer will wrap characters that go past the 160th print
  275.       position to the left side of the page. If you use a left
  276.       margin of 5, for example, you should set the column width to
  277.       -W77 to prevent wraparound (and use the truncate -T option).
  278.       There is no sure way to achieve a left margin without losing
  279.       characters other than physically shifting the paper to the
  280.       left.
  281.  
  282.     -A
  283.  
  284.       When multiple files are specified on the command line
  285.       (registered version only) you have the option of either
  286.       starting a new page for each file (default) or appending them
  287.       as though they were one continuous file. The -A option causes
  288.       them to be appended.
  289.  
  290.  
  291.     -Zfilename
  292.  
  293.       Allows output to be routed to a file instead of to the
  294.       printer. The file can then be printed in background while
  295.       running other programs. For example, to send output to a file
  296.       called PRINT.TXT, you should include -ZPRINT.TXT on the
  297.       command line.If PRINT.TXT does not exist, it will be created.
  298.       If PRINT.TXT already exists, 2col output will be appended to
  299.       the end of the file. This command is only active in the
  300.       registered version of 2col. This option can also be used to
  301.       redirect output to LPT2, COM1, COM2, etc.
  302.  
  303.  
  304.  
  305. Suggested Usage
  306.  
  307.     Create a batch file named "2.bat" containing a call for 2col
  308.     with your most often used options as part of the command line.
  309.     You need then only type "2" followed by the filename you wish to
  310.     print. You could also include options you wish to add or
  311.     override as part of the call. For example 2.bat might contain
  312.     the following line:
  313.  
  314.       2col -P -N -L86 %1 %2 %3 %4
  315.  
  316.     (%2 %3 %4 are there in case you enter options or additional
  317.     fileneames)
  318.  
  319.     The above set of options would cause 2col to pause before
  320.     printing each page. Each page would be 86 lines long and would
  321.     be numbered at the bottom.
  322.  
  323.  
  324. Distribution
  325.  
  326.     Permission is hereby given to copy and distribute this program
  327.     as long as no fee other than a minimal (<$10) handling cost is
  328.     charged. Please include all files in their original unmodified
  329.     form when distributing this program.
  330.  
  331.  
  332. Ye olde disclaimer
  333.  
  334.     The author has made all good faith attempts to provide a
  335.     reliable product. But there are no guarantees expressed or
  336.     implied that this program will work perfectly (or indeed at all)
  337.     or that it won't cause your data or hardware to self destruct.
  338.     If you are a registered user and become dissatisfied with the
  339.     program for any reason, I will be glad to refund your
  340.     registration fee but will not be liable for any damage(s)
  341.     whatever resulting from the use of this program.
  342.  
  343.  
  344.                                                      -Tony Caine-
  345.  
  346. GEnie mail:A.CAINE
  347.